portable: adopt Agent Plugins 1.0.0 as the pinned portable contract - #306
Merged
Conversation
Pin spec repository commit ff8ab5e39 with refreshed schema provenance, add dated adoption evidence (native-client roster, Cursor 3.18.25 IDE dogfood audit with three observed placeholder-expansion conformance gaps), bump the portable adapterRevision to 1.3.0, refresh the install surface wording, and add a repeatable installer/filesystem/pinned-schema conformance proof against an isolated Cursor home via a dedicated host-install-portable fixture.
🦋 Changeset detectedLatest commit: 3f4a1ee The changes in this PR will be included in the next version bump. This PR includes changesets to release 1 package
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
This was referenced Sep 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adopts the Agent Plugins open standard (agent-plugins.org, spec 1.0.0) as the contract of the existing
portabletarget — no new target, preserving the single-route contract — and pins fresh adoption evidence:PROVENANCE.json: re-verified schema hashes,retrievedAt: 2026-09-01, and the spec repository pin (agentplugins/agent-plugins-spec@ff8ab5e39, 2026-08-19).portable-1.0.0.jsoncapability table: dated adoption evidence (native-client roster incl. Cursor local loading) and the Cursor 3.18.25 IDE dogfood findings, including three observed client conformance gaps (no${PLUGIN_ROOT}expansion incwd/args, omitted-cwddefault is$HOMEnot plugin root).adapterRevision1.2.0 → 1.3.0; install surface (INSTALL.md) names the standard precisely and the native clients.runPortableHostInstallProofagainst a dedicatedhost-install-portablefixture — installer execution + isolated-Cursor-home filesystem shape + pinned-schema conformance + idempotency, with proof-scope language that explicitly does NOT claim IDE-loader evidence. (The shared host-install fixture is untouched; its probe skill's Codextargets:frontmatter extension correctly fails portable validation with AB6015, which is why the portable proof uses its own clean fixture.)docs/audits/2026-09-02-agent-plugins-cursor-ide-proof.md+ screenshots underdocs/assets/agent-plugins-cursor-proof/— the real Cursor 3.18.25 plugin loader (isolated instance) discovered the emitted plugin (Local badge), its skill, and its MCP config, and completed a stdio handshake once given a Cursor-launchable configuration.Why evolve
portable(notplugin, not a new target)portablealready emitted the exact Agent Plugins 1.0.0 layout (rootplugin.jsonwith the canonical$schema,skills/,mcp.json) with vendored schemas. Thepluginmulti-host bundle intentionally omits a rootplugin.jsonbecause Codex gives it precedence and would disable hooks/apps. A new target would duplicateportable's contract.Test plan
tsc --noEmit(build project),rslintclean